Summary

Final two hooks of Phase 2. After this lands, Phase 2 is fully complete (Tasks 21-31) and Phase 3 (Shell components — Topbar, Statusbar, SessionsRail, FlowStrip, App wiring) can begin.

• Task 28 — useApprovalsQueue() (web/src/state/useApprovalsQueue.ts) — pure composition over useSessionList(). Filters sessions where status === 'awaiting_input', sorts by updated_at ascending (oldest-waiting-first). Returns { queue, count, isLoading, error }. No new fetch, no new SSE — derives entirely from the cached session list. 3 tests.
• Task 29 — useAgentDefinitions() (web/src/state/useAgentDefinitions.ts) — @tanstack/react-query cache-once for /api/v1/agents. Returns { list, byName }: list for ordered iteration (FlowStrip), byName for O(1) lookup (SelectedPanel). staleTime: Infinity, gcTime: Infinity since agent definitions don't change at runtime. 3 tests.

Validation

• cd web && npm install → 0 vulnerabilities
• npm run typecheck → exit 0
• npx vitest run → 64 passed / 0 failed (PR feat(web): React UI v2.0 — Phase 2 Tasks 26+27+30+31 (data hooks + selectedRef) #22's 58 + 6 new)
• npm run build → clean

Nothing touches src/runtime/ — no dist/app.py regen.

Phase 2 retrospective

What's next

Phase 3 (Tasks 32-36): Shell components — Topbar, Statusbar, SessionsRail, FlowStrip, App wiring. These compose all of Phase 2's hooks into the visible UI shell.

Test plan

• Vitest: 64/64 pass
• Typecheck: exit 0
• Build: clean
• Pytest backend stays green
• CI: lint + type + test + sonar + bundle + skill-lint
• CI: SonarCloud quality gate

🤖 Generated with Claude Code